/*
 * Field.java
 *
 * Created on 20 marzo 2004, 10.44
 */

package net.ermannofranco.xml.schema;

/**
 * 
 * @author ermanno (ermanno.franco@gmail.com)
 */
public class Field extends SchemaTag {

	private static final long serialVersionUID = -8276477730099681212L;
	private boolean assigned;

	/**
	 * Creates a new instance of Field Protetto
	 * 
	 * @param level
	 *            livello di indentazione
	 * @param container
	 *            tag contenitore
	 */
	protected Field(int level, ISchemaTag container) {
		super("field", level, container);
	}

	/**
	 * @param XPathExpr
	 * @return
	 */
	public Field setXPathExpr(String XPathExpr) {
		addAttr("xpath", XPathExpr);// controllo? no, cdata
		assigned = true;
		return this;
	}

	/**
	 * aggiunge un tag Annotation che contiene un tag Documentation
	 * 
	 * @param explanation
	 *            Stringa di documentazione
	 * @return autoriferimento all'oggetto corrente
	 */
	public Field addDocumentation(String explanation) {
		addAnnotation().addDocumentation(explanation);
		return this;
	}

	/**
	 * aggiunge un tag Annotation che contiene un tag Documentation
	 * 
	 * @param explanation
	 *            testo della documentazione
	 * @param language
	 *            attributo di xml:lang, seguire le regole di i18n
	 * @return riferimento all'oggetto corrente
	 */
	public Field addDocumentation(String explanation, String language) {
		addAnnotation().addDocumentation(explanation, language);
		return this;
	}

	private void validateUnique() {
		if (!assigned)
			throw new SchemaException("namespace e' obbligatorio, "
					+ getClass().getName() + ":(" + getName() + ")");
	}

	/**
	 * semplice override di convalida
	 * 
	 * @return
	 */
	public String toSave() {
		validateUnique();
		return super.toSave();
	}

	public String toPrint() {
		validateUnique();
		return super.toPrint();
	}
}
